home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / bbroul11.zip / RLSYSOP.DOC < prev    next >
Text File  |  1992-12-11  |  13KB  |  286 lines
  1.     //////////////////////////////////////////////////////////////////
  2.     /                                                                /
  3.     /                           BBS Roulette                         /
  4.     /                           Version 1.1                          /
  5.     /                                                                /
  6.     /                        (c) Copyright 1992                      /
  7.     /                        All Rights Reserved                     /
  8.     /                          J & W Software                        /
  9.     /                                                                /
  10.     /                                                                /
  11.     /       DOOR game for Wildcat!, PCBoard 14.x, RA/QBBS, GAP,      /
  12.     /       SPITFIRE  and  other BBS  software which  uses door      /
  13.     /       information files compatible with the above.             /
  14.     /                                                                /
  15.     /                                                                /
  16.     /                           Support BBS:                         /
  17.     /                          Gulf Coast BBS                        /
  18.     /                          (904) 563-2547                        /
  19.     /                     1200 - 14400 HST/v.32bis                   /
  20.     //////////////////////////////////////////////////////////////////
  21.  
  22.  
  23.     INTRODUCTION
  24.     ------------
  25.  
  26.     BBS Roulette is a DOOR implementation of the popular gambling game
  27.     Roulette. Play  is very  similar  to Roulette as  played  in major
  28.     casinos.  Players  compete  for weekly  as  well as  all time high
  29.     scores.
  30.  
  31.  
  32.     FEATURES
  33.     --------
  34.  
  35.     - ANSI Color and Mono screens
  36.     - Full multi-node support
  37.     - Support for locked DTE up to 115K bps
  38.     - Support for COM1 through COM8 and IRQs 1 through 15
  39.     - FOSSIL support
  40.     - DESQview aware
  41.     - Easy installation and no maintenance
  42.  
  43.  
  44.     SETUP
  45.     -----
  46.  
  47.     Setup  is  very simple.  Create a directory and  place  the  files 
  48.     ROULETTE.EXE and RLSETUP.EXE in this directory.
  49.  
  50.     Change to  this directory and run RLSETUP.  A screen with  several
  51.     fields  will be displayed.  There will be a box at the  bottom  of 
  52.     the  screen that will  display  help  information for each  field.
  53.     The  following  edit keys  are allowed: HOME, END, BACKSPACE, LEFT
  54.     and RIGHT ARROW. Use the ENTER,  UP  and  DOWN  ARROW keys to move
  55.     between the different fields.
  56.  
  57.     Each field is described below:
  58.  
  59.     Name: The name of the person registering the program as it will be
  60.     displayed on  the opening screen (when registered).  This does not
  61.     necessarily have  to  be the SysOp, it could be the name of a user
  62.     who donated the registration fee.
  63.  
  64.     BBS Name:  The  name of the  BBS  as  it  will be displayed on the
  65.     opening screen (when registered).
  66.  
  67.     Key Number:  If registered, enter your Key Number here.  Until the
  68.     program  is registered leave this field  as  all zeroes.   See the
  69.     registration section below for more information about registering.
  70.  
  71.     Allowable turns per day:  The number of turns per day that will be
  72.     allowed.  Players will be allowed  to call in any  number of times
  73.     during the day to complete their number of turns
  74.  
  75.     Path and Name of ANSI Bulletin: Path and name for the ANSI (Color)
  76.     bulletin file. If left blank no file will be written.
  77.  
  78.     Path and Name of ASCII Bulletin: Path and name for the ASCII (Non-
  79.     Color) bulletin file.  If left blank no file will be written.
  80.  
  81.     Use  Internal  or  FOSSIL  com   routines  [I/F]:    The  type  of
  82.     communications support  that should be used.  BBS Roulette can use
  83.     either its own  Internal  communication  routines  or an installed
  84.     FOSSIL  driver.  For  systems  not  using a FOSSIL driver,  choose
  85.     Internal  routines.  The Internal  communication routines  support
  86.     COM1 through COM8 with IRQs  of 1 through 15.  For systems using a
  87.     FOSSIL  driver,  you  may choose  either the  Internal  or  FOSSIL
  88.     routines.
  89.  
  90.     Base Address  (COM1 through COM8):  If you are  using the Internal
  91.     communication routines on ports  other than  COM1 or COM2 you must
  92.     enter the Base Address of the ports, in hex, for the ports you are
  93.     using.  Note that  the Base Address  for COM1 and  COM2  cannot be
  94.     changed.
  95.  
  96.     IRQ  (COM1 through COM8):   If  you   are   using   the   Internal
  97.     communication  routines on ports other  than COM1 or COM2 you must
  98.     enter the IRQ of the  ports you are using.  Note that the IRQs for
  99.     COM1 and COM2 cannot be changed.
  100.  
  101.     After entering all of the  information, press 'ESC'.  RLSETUP will
  102.     ask if you want  to save the configuration  file.   If this is the
  103.     first  time  RLSETUP  has  been  run  or  you  have previously run
  104.     RLSETUP but changed some of the information, press 'Y'.  This will
  105.     will  create or update the configuration file  (ROULETTE.CFG).  It
  106.     will also create a  ROULETTE.SCO  file if one does not exist. This
  107.     is the score file and is needed for the program to run.
  108.  
  109.     RLSETUP will then ask if you  want to create the registration file
  110.     (ROULETTE.REG).  The  registration  file will be needed  when  the
  111.     program is registered, so you will need to answer 'Y' at least one
  112.     time for this file to be created.  Please be sure all  information 
  113.     is correct as your 'Key Number' will be based on this information.
  114.  
  115.     Consult your BBS manual regarding the creation of DOOR batch files
  116.     for your BBS.  ROULETTE.EXE must be  started from the directory it
  117.     resides in for the game to function.  The command line for calling 
  118.     BBS Roulette is as follows:
  119.  
  120.     ROULETTE ROULETTE.CFG 'Full path and name of BBS information file'
  121.  
  122.     'Full path and name of BBS information file'
  123.  
  124.     This  will be the full path and filename of your  BBS  information 
  125.     file.  For  example:  C:\PCB\PCBOARD.SYS. BBS Roulette  uses  this
  126.     filename  to  determine the BBS software which is  being  used  as 
  127.     follows:
  128.  
  129.     CALLINFO.BBS (Wildcat 2.xx)
  130.     PCBOARD.SYS  (PCBoard)
  131.     DOOR.SYS     (GAP, Wildcat! 3.0 and other systems using DOOR.SYS)
  132.     SFDOORS.DAT  (SPITFIRE)
  133.     DORINFOx.DEF (RA/QBBS/RBBS)
  134.  
  135.     Please  note that the DORINFOx.DEF file that RA/QBBS uses  is  not
  136.     fully compatible with RBBS.  By default, BBS Roulette uses the RA/
  137.     QBBS  DORINFOx.DEF format.  If you  are using  the RBBS version of
  138.     DORINFOx.DEF,  use the parameter  "/RBBS"  (without quotes) on the
  139.     command line in your calling batch file.
  140.  
  141.     An example of a batch file for PCBoard:
  142.  
  143.     CD\ROULETTE
  144.     ROULETTE ROULETTE.CFG C:\PCB\PCBOARD.SYS
  145.     CD\PCB
  146.     BOARD.BAT
  147.  
  148.     An example of a batch file for RBBS:
  149.  
  150.     CD\ROULETTE
  151.     ROULETTE ROULETTE.CFG C:\RBBS\DORINFO1.DEF /RBBS
  152.     CD\RBBS
  153.     BOARD.BAT
  154.  
  155.  
  156.     UPGRADING
  157.     ---------
  158.  
  159.     To upgrade, replace the v1.0  ROULETTE.EXE  and  RLSETUP.EXE files
  160.     with the v1.1 ROULETTE.EXE and  RLSETUP.EXE files and run RLSETUP.
  161.  
  162.     If you  are  using  the  RBBS  version  of  DORINFOx.DEF,  add the
  163.     parameter  "/RBBS"  (without quotes)  to the  command  line in the
  164.     calling batch file.
  165.  
  166.  
  167.     ERRORS
  168.     ------
  169.  
  170.     Any  errors  which may occur  will be written to the  ROULETTE.ERR
  171.     file.  When possible, a descriptive error message will be  written 
  172.     to  ROULETTE.ERR  with the exact cause of the error. If the  error
  173.     cannot  be resolved,  call the  support BBS  (Gulf Coast BBS)  and
  174.     upload a copy of your ROULETTE.CFG, ROULETTE.SCO and  ROULETTE.ERR
  175.     files.  This will allow us to more quickly  determine the cause of
  176.     the error.  All support is handled through the Gulf Coast BBS.
  177.  
  178.  
  179.     MULTI-NODES, NETWORKS, MULTI-TASKERS
  180.     ------------------------------------
  181.  
  182.     BBS Roulette has been  developed in a  networked environment.  All
  183.     multi-node features have been thoroughly tested on multi-node sys-
  184.     tems using DESQview and Peer-To-Peer Local Area Networks. DOS 3.1+
  185.     full record and file locking is supported.  Multiple configuration
  186.     files are NOT necessary when running on multi-node systems.
  187.         
  188.     BBS Roulette  is  DESQview aware.  It is  automatically  detected,
  189.     screen and  keyboard I/O are  "well behaved",  and time slices are
  190.     released  back  to  other  applications  where  appropriate.   BBS
  191.     Roulette has been tested with 3 nodes running simultaneously under
  192.     DESQview (all ports locked at 38400)  with no noticeable effect on
  193.     other nodes.
  194.  
  195.  
  196.     MISCELLANEOUS
  197.     -------------
  198.  
  199.     At the  beginning of  each week the score  file will automatically
  200.     be cleared and last week's high scorer will be determined. The old
  201.     score file will be saved in ROULETTE.BAK.  This file is not needed
  202.     for normal operation of the program and may deleted if you desire.
  203.  
  204.     If you are using a high speed modem and have your com port LOCKED, 
  205.     the  program will not respond to keyboard input while  your  modem 
  206.     buffer is full.  This is normal.
  207.  
  208.     BBS Roulette may be played from the DOS prompt by typing:
  209.  
  210.     ROULETTE ROULETTE.CFG LOCAL
  211.  
  212.     Note the user name is hard coded as 'SysOp' and that the bulletins
  213.     and score file will not be updated. This mode is only intended for
  214.     testing. The file LOCAL.BAT is included for this purpose.
  215.  
  216.     To turn on screen writing, if it is off, press any key.
  217.  
  218.  
  219.     REGISTRATION
  220.     ------------
  221.  
  222.     Registration is required if you choose to continue using this DOOR 
  223.     program.   After 60 days of running the program unregistered,  the 
  224.     score  file  will  cease to be updated.  However,  the  game  will 
  225.     continue  to allow players to play. This should be long enough  to 
  226.     determine if the program meets your needs and is popular with your 
  227.     users.
  228.  
  229.     When  registered, the '[UNREGISTERED COPY]' line will be  replaced 
  230.     with a 'Registered To:' message.  This will show the Name and  BBS 
  231.     Name from the ROULETTE.CFG file.
  232.  
  233.     There are two ways to register.
  234.  
  235.                         * Mail order Registration *
  236.  
  237.     If the ROULETTE.REG  form was not  previously created, run RLSETUP
  238.     and have  it create ROULETTE.REG.  Check this  file to  insure the
  239.     information is correct.  If it is not, re-run  RLSETUP and correct
  240.     any errors.   Your Key Number is based on the information in  this
  241.     file  and must be correct for your  Key Number to work.  Make sure
  242.     that the Name and BBS Name are correct as printed! When done print
  243.     the form  to your printer.  Send the  completed  ROULETTE.REG form
  244.     along with  your check, money order,  VISA, MasterCard or Discover
  245.     credit card information for $15.00 (US) to:
  246.  
  247.                               J & W Software
  248.                           9426 N. China Pink Way
  249.                       Crystal River, FL  34428-9500
  250.  
  251.     Your personalized Key Number will be sent to you promptly. When it
  252.     is received, run RLSETUP and enter  your Key Number.  BBS Roulette
  253.     will then be registered. No other action is necessary.
  254.  
  255.  
  256.                      * Instant On-Line Registration *
  257.  
  258.     You may register BBS Roulette with  VISA,  MasterCard or  Discover
  259.     and receive your  personalized Key Number instantly by calling the
  260.     Gulf Coast BBS, (904) 563-2547, and entering  REGISTER at the main
  261.     menu prompt.  You will need the Name and BBS Name exactly as it is
  262.     entered on  lines 1 & 2  of  RLSETUP  as well as  your credit card
  263.     information to  register.  You  might  want  to make  note of this
  264.     information to speed  your call.  You will receive your Key Number
  265.     on that call.
  266.  
  267.  
  268.     WARRANTY & DISCLAIMER
  269.     ---------------------
  270.  
  271.     There  are  no warranties, express or  implied,  for  unregistered 
  272.     copies of BBS Roulette. The author will NOT be held liable for any
  273.     direct,  indirect, incidental, or consequential  damage  resulting 
  274.     from  the  use  of  this  program.   Your  use  of  this   program 
  275.     constitutes your AGREEMENT to this disclaimer and your release  of 
  276.     the author from any form of liability.
  277.  
  278.     Registered  copies of  BBS Roulette  are  warranted  to perform as
  279.     described  in this documentation.  In the  event BBS Roulette does
  280.     not  perform as described, the author will elect to either rectify
  281.     the  problem or refund  the amount  paid, provided notification is
  282.     received within 30 days of registration.
  283.  
  284.  
  285.                                  - END -
  286.